home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload Trio 2
/
Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO
/
dir39
/
csstools.zip
/
CSSTOOLS.TXT
< prev
next >
Wrap
Text File
|
1992-09-25
|
41KB
|
836 lines
CSS DESKTOP UTILITIES
SHAREWARE EVALUATION VERSION
REFERENCE MANUAL
Version 1.0
Common Sense Software
P.O. Box 50941
Indianapolis, Indiana 46250
(317) 594-0820
This manual and the CSS Desktop Utilities are Copyright (C) 1992
by Common Sense Software. All rights reserved.
Family Tree Print Utility, GENCHECK, and Common Sense Software
are trademarks of Common Sense Software.
GENCHECK - Page 2
TABLE OF CONTENTS
COPYRIGHT...................................................2
LIMITATION OF LIABILITY.....................................2
SHAREWARE REGISTRATION INFORMATION..........................3
TRADEMARK ACKNOWLEDGMENT....................................4
SUPPORT.....................................................4
REQUIRED EQUIPMENT..........................................5
INTRODUCTION................................................5
INSTALLATION................................................5
BIFF.EXE - BINARY FILE DIFFERENCE UTILITY...................5
DIFF.EXE - ASCII FILE DIFFERENCE UTILITY....................7
FASTFORM.EXE - FAST DISK FORMATTER UTILITY..................10
GREN.EXE - GENERIC RENAME UTILITY...........................11
OPERATION - SEARCH.EXE......................................12
A LOOK AHEAD................................................14
REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0.......16
COPYRIGHT
The CSS Desktop Utilities and manual are Copyright 1992 by Common
Sense Software. Portions Copyright 1982-1990 Microsoft Corp.
LIMITATION OF LIABILITY
THE CSS DESKTOP UTILITIES SOFTWARE ARE SUPPLIED AS IS. COMMON
SENSE SOFTWARE MAKES NO WARRANTY OR REPRESENTATION, EITHER
EXPRESSED OR IMPLIED, WITH RESPECT TO THESE PROGRAMS, REFERENCE
MANUAL OR DOCUMENTATION INCLUDING THEIR QUALITY, PERFORMANCE,
MERCHANT ABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT WILL COMMON SENSE SOFTWARE BE LIABLE FOR DIRECT,
INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THESE PROGRAMS, REFERENCE
MANUAL OR DOCUMENTATION, EVEN IF COMMON SENSE SOFTWARE IS ADVISED
OF THE POSSIBILITY OF SUCH DAMAGES. IN PARTICULAR, COMMON SENSE
SOFTWARE IS NOT RESPONSIBLE FOR ANY COSTS INCLUDING BUT NOT
LIMITED TO THOSE INCURRED AS A RESULT OF LOST PROFITS OR REVENUE,
LOSS OF USE OF COMPUTER PROGRAMS, LOSS OF DATA, THE COST OF
SUBSTITUTE PROGRAMS, CLAIMS BY THIRD PARTIES OR FOR OTHER SIMILAR
COSTS. IN NO EVENT SHALL COMMON SENSE SOFTWARE'S LIABILITY FOR
ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE SOFTWARE LICENSE,
REGARDLESS OF THE FORM OF CLAIM. THE PERSON USING THE SOFTWARE
BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
Some states do not allow the exclusion of the limit of liability
for consequential or incidental damages, so the above limitation
may not apply to you.
This agreement shall be governed by the laws of the State of
Indiana and shall inure to the benefit of Common Sense Software
and any successors, administrators, heirs and assigns. Any
action or proceeding brought by either party against the other
arising out of or related to this agreement shall be brought only
GENCHECK - Page 3
in a STATE or FEDERAL COURT of competent jurisdiction located in
HAMILTON county, INDIANA. The parties hereby consent to in
personam jurisdiction of said courts.
Common Sense Software reserves the right to update the contents
of the CSS Desktop Utilities and their associated documentation
at its discretion and without the consent of or any obligation to
any licensed users.
SHAREWARE REGISTRATION INFORMATION
Shareware distribution gives users a chance to try software
before buying it. If you try a Shareware program and continue
using it, you are expected to register. Individual programs
differ on details - some request registration while others
require it, some specify a maximum trial period. With
registration, you get anything from the simple right to continue
using the software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software,
and the copyright holder retains all rights, with a few specific
exceptions as stated below. Shareware authors are accomplished
programmers, like commercial authors, and programs are of
comparable quality. (In both cases, there are good programs and
bad ones!) The main difference is in the method of distribution.
The author specifically grants the right to copy and distribute
the software, either to all and sundry or to a specific group.
For example, some authors require written permission before a
commercial disk vendor may copy their Shareware.
Shareware is a distribution method, not a type of software. You
should find software that suits your needs and pocketbook,
whether it's commercial or Shareware. The Shareware system makes
fitting your needs easier, because you can try before you buy.
And because the overhead is low, prices are low also. Shareware
has the ultimate money-back guarantee - if you don't use the
product, you don't pay for it.
The CSS Desktop Utilities are Shareware programs and are provided
at no charge to the user for evaluation. The essence of "user-
supported" software is to provide personal computer users with
quality software without high prices, and yet to provide
incentive for programmers to continue to develop new products.
If you find these programs useful and are continuing to use them
after a reasonable trial period, you must make a registration
payment of $10 to Common Sense Software. The CSS Desktop
Utilities took many man-hours of software development effort to
produce, and registration fees are the ONLY WAY the authors
receive compensation for their time and effort. Help to keep the
Shareware concept alive and well by becoming a registered user
after your evaluation period. The CSS Desktop Utilities are not
copy protected or "crippled" in any way from the registered
user's version; Common Sense Software is counting on each user's
GENCHECK - Page 4
honesty to register their copy. EVERY REGISTRATION COUNTS,
INCLUDING YOURS!
The cost of registration is $10. As a registered user, you will
receive the latest registered user's version of the programs and
a registration number which will allow us to inform you of future
enhancements, and provide you with upgrades and new products at
reduced prices. Registered users also receive technical support
by both mail and phone. A registration form is provided at the
end of this documentation for your convenience.
Common Sense Software is a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware
principle works for you. If you are unable to resolve a
shareware-related problem with an ASP member by contacting the
member directly, ASP may be able to help. The ASP Ombudsman can
help you resolve a dispute or problem with an ASP member, but
does not provide technical support for members' products. Please
write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
or send a CompuServe message via CompuServe Mail to ASP Ombudsman
70007,3536.
TRADEMARK ACKNOWLEDGMENT
Common Sense Software is a trademark of Common Sense Software.
Microsoft and MS-DOS are registered trademarks of Microsoft
Corporation. IBM, XT, AT and PC-DOS are registered trademarks of
International Business Machines Corporation.
SUPPORT
Support will be provided to REGISTERED USERS by mail, CompuServe,
Prodigy, and telephone. Telephone support will be available
weekday evenings from 6PM to 9PM Eastern Standard Time (EST) and
weekends from 10AM to 5PM EST.
CompuServe: E-Mail to: Keith R. Wehmeyer (70274,3020)
Prodigy: E-Mail to Keith R. Wehmeyer (VMSR09A)
Address: Common Sense Software
P.O. Box 50941
Indianapolis, Indiana 46250
Phone: (317) 594-0820
Please note that we are unable to assist you with directions
concerning the use of other programs with the CSS Desktop
Utilities.
REQUIRED EQUIPMENT
GENCHECK - Page 5
The CSS Desktop Utilities will run on most IBM or compatible
computers with 256K of RAM, PC-DOS or MS-DOS 2.1 or greater and
two disk drives.
INTRODUCTION
The CSS Desktop Utilities were created to assist in the every-day
operation of the typical computer user. The utilities consist of
five programs with the following capabilities:
1.BIFF.EXE - A Binary file "Difference" program, which compares
two binary files and looks for differences. This can be used
to compare two separate data files in order to note any
changes or differences.
2.DIFF.EXE - An ASCII file "Difference" program, which compares
two human-readable text files to find changes or differences.
3.FASTFORM.EXE - A fast formatting program which can be run from
a .BAT file, and formats 360K, 720K, 1.2M, and 1.44M diskettes
(both 5.25" and 3.5") with a variety of options. Formatting
can be accomplished in as little as 28 seconds for a 360K
diskette, compared to 40 seconds for DOS's FORMAT.
4.GREN.EXE - A Generic Rename program, which can rename files
and sub directories, and automatically move renamed files to
new sub directories.
5.SEARCH.EXE - A file Search program, which scans one or
multiple files for a given phrase or word.
This manual is divided into the following sections. The first
part provides installation and set-up information so you can get
the CSS Desktop Utilities running on your computer. A brief
description of how to operate each utility program then follows.
While the CSS Desktop Utilities were designed to be operated by
the computer novice with little training, please take the time to
read this manual and get to know their capabilities. It is best
to run each utility program as you read along, so that you can
understand exactly how it works.
Enjoy the programs! We hope the CSS Desktop Utilities are a
valuable assistant in you everyday computer operation.
INSTALLATION
Installation of the CSS Desktop Utility programs is easy, even
for the novice computer user. Simply insert the Master diskette
into your diskette drive (A: or B:) then run the installation
program by typing "A:INSTALL" or "B:INSTALL" and pressing the
ENTER key. Follow the directions which follow to install the
programs on either a floppy diskette or your hard drive.
BIFF.EXE - BINARY FILE DIFFERENCE UTILITY
BIFF.EXE is the binary version of DIFF; it does differences on
any file type, byte by byte, in binary mode, displaying the
GENCHECK - Page 6
differences in hexadecimal (Base 16) notation. While similar to
the DIFF utility, it differs in a number of significant ways. In
normal mode, BIFF will list the difference regions sequentially,
separated by a double bar, with the first file's contents on top.
Each line of output is preceded by the starting byte number.
Bytes are numbered in the file starting at 1. Each byte in the
difference region will be shown in hexadecimal notation on the
left, and ASCII notation on the right, separated by a vertical
bar. If a byte cannot be represented in ASCII on the screen
and/or printer, it will be shown as an asterisk ('*'). In
parallel mode, each difference region will contain all of the
bytes in the difference section, but no ASCII representation.
Both modes provide a closing summary, consisting of the number of
difference sections found, and the number of total bytes in those
sections.
When invoking BIFF, you mush supply the name of at least two
files for BIFF to operate on. If they are not supplied, or are
specified incorrectly, BIFF will prompt you for them. Other
command line parameters you may wish to supply, but for which you
will not be prompted, include the following:
PARALLEL - or any abbreviation thereof, in upper, mixed or lower
case. If selected, the differences between the files will be
presented to you in the parallel format discussed above, with a
file name header, and concurrent difference regions headed by the
starting file byte number.
OUTPUT FILE - If a third file name is specified on the command
line, BIFF will write it's output to this file and not the
screen. If the file already exists, it is over-written without
any warning.
MATCH - the number of bytes that must match after a section of
differing data before BIFF decides that the files are
resynchronized. The default is 30 bytes. MATCH can be between 1
and 79.
WIDTH - the number of characters per line BIFF will display. In
the parallel mode, the number of displayed bytes from each file
is roughly equal to (WIDTH / 6 - 1), while in normal mode it is
(WIDTH / 4 - 3). The default value is 80 characters, with valid
values extending upward to 255 characters.
BIFF will apply the integers you supply in the command line to
the proper parameters according to their value. Input files must
be specified first and the output file specified last, and any
other parameters which are not numbers or 'parallel' will be
ignored. MATCH and WIDTH parameters may be specified multiple
times, the last values read being the ones BIFF will use. File
name and integer parameters may be intermixed. An example:
C> biff first.dat 40 second.dat 132 file.dif
GENCHECK - Page 7
This command entry would cause BIFF to calculate the differences
between FIRST.DAT and SECOND.DAT using a match value of 40 bytes,
and place the 132 column wide output in the file FILE.DIF.
Another example:
C> biff 140 file.xxx file.yyy lpt1 2 para
This command entry would cause BIFF to print the differences
between FILE.XXX and FILE.YYY with 140 character wide output
being sent to the printer attached to the first parallel port of
the machine. The differences would be calculated with a match
value of 2 bytes and displayed in the parallel format.
BIFF produces output that contains characters only printable by
an IBM ProPrinter or compatible device. IBM ProPrinter XLs can
be fed with 8-, 11-, or 14-inch paper, and print in pica (10
CPI), elite (12 CPI), or condensed (17.1 CPI) print modes.
Consult your ProPrinter User's Manual for instructions on loading
different sizes of paper and invoking the different print modes.
Use the chart below to determine the number of characters per
line for each setup:
Paper width
8" 11" 14"
+-----+-----+-----+
10 : 80 : 110 : 140 :
C +-----+-----+-----+
P 12 : 96 : 132 : 168 :
I +-----+-----+-----+
17 : 137 : 188 : 239 :
+-----+-----+-----+
While BIFF should work on just about any file you may have, it
does have some limitations:
Maximum number of:
bytes per file - 4,294,967,295 (4 MBytes - 1)
bytes per difference section - 65,534
difference sections - 65,535
BIFF gives no warning when these limits are reached, and may halt
DOS or other programs in memory if they are exceeded.
DIFF.EXE - ASCII FILE DIFFERENCE UTILITY
DIFF.EXE is the equivalent of the VMS DIFF command, found on the
VAX line of computers by Digital Equipment Corporation. However,
there are several differences. Unlike the VMS command, DIFF will
not work predictably on binary files, nor will it recognize
differences in lines beyond the 255th character. Many of the VAX
qualifiers are not supported in this version, but sufficient
interest in these features could prompt their integration.
GENCHECK - Page 8
When invoking DIFF, you mush supply the name of at least two
files for DIFF to operate on. Wild cards are supported in the
first file name only. If wild cards are used, the second file
name must be a valid DOS path name. If they are not supplied, or
are specified incorrectly, DIFF will prompt you for them.
If a wild card name is specified, DIFF will search for files that
match the wild card spec. in the directory specified with that
name, or the default directory if none is specified. It will
then search for each found file by name in the path specified in
the second file name. If no match is found for that file, a
message is printed to that effect, and processing continues.
Other command line parameters you may wish to supply, but for
which you will not be prompted, include the following:
PARALLEL - or any abbreviation thereof, in upper, mixed or lower
case. If selected, the differences between the files will be
presented to you in the VMS /PARALLEL format with a file name
header, and concurrent difference regions headed by the starting
line number. If not selected, the difference regions will be
listed sequentially, separated by a double bar, with the first
file's contents on top. Both modes provide a closing summary.
TABS - or any abbreviation thereof, in upper, mixed or lower
case. If selected, this qualifier instructs DIFF to treat any
tabs found in each file as the appropriate number of blanks
during the compare operation. Without this qualifier, DIFF will
identify lines as different when a tab has replaced one or more
blanks in the original (or vice-versa), even though the lines in
the output appear to be identical. With this qualifier, DIFF
will evaluate the lines based on their perceived spacing.
OUTPUT FILE - If a third file name is specified on the command
line, DIFF will write it's output to this file and not the
screen. If the file already exists, it is over-written without
any warning.
MATCH - the number of lines that must match after a section of
differing text before DIFF decides that the files are
resynchronized. The default is 3 lines, the same as the VAX.
MATCH can be between 1 and 79 lines.
WIDTH - the number of characters per line DIFF will display. In
the parallel mode, the number of displayed characters from each
file is roughly equal to (WIDTH / 2 - 2). The default value is
80 characters, with valid values extending upward to 255.
GRAPHICAL - By default, DIFF uses ASCII characters to draw the
separator bars (or in parallel mode, boxes) in the output
listing. If you would like DIFF to use the extended ASCII set
line drawing characters to make these, specify GRAPHICAL, or any
abbreviation thereof, in upper, mixed or lower case. These line
drawing characters make for better-looking output, but take a
GENCHECK - Page 9
long time to print on a ProPrinter printer, and some printers
(e.g. Epson) won't handle them at all. In general, you should
only use GRAPHICAL output for presentation purposes.
DIFF will apply the integers you supply in the command line to
the proper parameters according to their value. Input files must
be specified first and the output file specified last, and any
other parameters which are not numbers or 'parallel' or 'tabs'
will be ignored. MATCH and WIDTH parameters may be specified
multiple times, the last values read being the ones DIFF will
use. File name and integer parameters may be intermixed. An
example:
C> diff first.dat 4 second.dat 132 file.dif
This command entry would cause DIFF to calculate the differences
between FIRST.DAT and SECOND.DAT using a match value of 4 lines,
and place the 132 column wide output in the file FILE.DIF.
Another example:
C> diff 140 *.c source\ lpt1 2 para gra
This command entry would cause DIFF to print the differences
between all the files matching the wild card specification *.C
and those files matching the same wild card name in the sub
directory SOURCE\. The output will be 140 columns wide, and sent
to the printer attached to the first parallel port of the
machine. The differences would be calculated with a match value
of 2 lines and displayed in the parallel format. The printer
attached must be able to handle the IBM extended character set
line drawing characters, as GRAPHICAL output boxes have been
specified.
In GRAPHICAL mode, DIFF produces output that contains characters
only printable by an IBM ProPrinter or compatible device. IBM
ProPrinter XLs can be fed with either 8-, 11-, or 14-inch paper,
and print in either pica (10 CPI), elite (12 CPI), or condensed
(17 CPI) print modes. Consult your ProPrinter manual for
instructions on loading different sizes of paper and invoking the
different print modes. Use the chart below to determine the
number of characters per line for each setup:
Paper width
8" 11" 14"
+-----+-----+-----+
10 : 80 : 110 : 140 :
C +-----+-----+-----+
P 12 : 96 : 132 : 168 :
I +-----+-----+-----+
17 : 137 : 188 : 239 :
+-----+-----+-----+
Only files written with CR or CR-LF record separators will work
correctly with DIFF. EDLIN, QuickC, Programmer's Workbench and
GENCHECK - Page 10
EDT+ all produce files of this type. Files downloaded to the PC
with KERMIT or XMODEM are usually written in this manner. Files
created with Word, Write and Displaywrite must be exported to
ASCII before DIFF can be used effectively on them.
Maximum number of:
files per run - unlimited
lines per file - 32767
chars per line - 256
difference sections - 32767
difference lines - 32767
FASTFORM.EXE - FAST DISK FORMATTER UTILITY
FASTFORM is a general purpose, high speed disk formatting program
which supports IBM PCs, XTs, and ATs and compatibles, as well as
both 5.25" and 3.5" diskette drives. FASTFORM uses your
computer's BIOS (Basic Input / Output System) to control your
floppy drive, permitting it to work with nearly all types of disk
drive and controller card combinations.
All FASTFORM parameters must be supplied on the command line
using the following syntax. Parameters not meeting the syntax
will be ignored.
C> fastform [DRIVE] [DENSITY] [/V] [/nnn]
The parameter DRIVE specifies which drive is to be formatted.
The permissible values are A: or B:, as FASTFORM does not support
hard disk formatting. If DRIVE is not specified, FASTFORM
assumes the A: drive.
The DENSITY parameter specifies if the density of the format.
The permissible values are LOW or HIGH, which may be entered in
any combination of upper and lower case letters. For a 5.25"
diskette drive, use LOW to format a 360K floppy, and HIGH to
format a 1.2M floppy. For a 3.5" diskette drive, use LOW to
format a 720K floppy, and HIGH to format a 1.44M floppy. If
DENSITY is not specified, FASTFORM determines the type of drive
in the computer and attempts to format the diskette for the
highest density possible in that drive.
Diskettes may be optionally verified while they are being
formatted by adding the /V qualifier in either upper or lower
case. Diskettes which are verified take longer to format, but
are guaranteed to have correct formatting information on each
track. By default, no verification is performed, so that
diskettes may be formatted as quickly as possible
The final FASTFORM parameter is used to specify the number of
sectors which will be allocated to diskette directory area. Each
sector holds information on up to 16 files. Both 360K and 720K
diskettes by default allocate 7 sectors, for a total of 42 files
permissible on a single diskette. High density diskettes, such
GENCHECK - Page 11
as 1.2M and 1.44M, allocate 14 sectors, for a total of 84 files
per diskette. You may choose to reduce the number of sectors
allocated for directory space in order to maximize free space
(for BACKUP purposes, for example), or you may expand the amount
of directory space allocated in you want to put many small files
on a single diskette. Maximum allocation values are as follows:
360K diskette 23 sectors
720K diskette 85 sectors
1.2M diskette 141 sectors
1.44M diskette 169 sectors
If no parameter is specified, FASTFORM uses the default values
normally used by DOS for the formatting process. An example:
C> fastform
FASTFORM will format a diskette in the A: drive at the highest
possible density for that drive, with no verification, and with
the default number of sectors allocated for directory storage.
C> fastform b: low /v /10
FASTFORM will format a diskette in the B: drive at LOW density
(360K or 720K, depending upon the drive type) and verify while
formatting. FASTFORM will then allocate 10 sectors for directory
space, permitting 160 files to be stored on this diskette.
Another significant advantage of FASTFORM over the DOS FORMAT
command is its ability to be run from a Batch file. FASTFORM
will wait to begin formatting until a diskette is inserted and
ready to format. This includes testing to make sure that the
diskette is not write-protected. If any problems occur during
the formatting process, an error message is displayed and a non-
zero number is returned to the Batch file using the DOS
ERRORLEVEL parameter. See your DOS manual for additional
information on ERRORLEVEL and how you can use it in your DOS
Batch file application.
GREN.EXE - GENERIC RENAME UTILITY
GREN is a general rename utility for the PC. Not only can it
rename files, but sub-directories as well, and can move files
from one sub directory to another. Sub-directories cannot be
moved.
GREN must be called with two arguments. The first is the current
name of the object, and the second is the new name. Only the
first two arguments are acted upon.
Examples:
C> GREN fred.dat george.dat
GENCHECK - Page 12
This example will rename the file FRED.DAT in the current sub-
directory to GEORGE.DAT.
C> GREN \data\new \data\old
This example renames the sub-directory NEW to OLD. Note that the
directory is referenced from the top level directory. This allows
the renaming of sub-directories not in the current tree.
C> GREN old\data old\buddy
This example renames the sub-directory OLD to BUDDY, but it is
referenced from the current working directory.
C> GREN \input\file.in \output\file.out
This example renames the file FILE.IN to FILE.OUT, and moves it
to the OUTPUT sub-directory.
Error Messages:
'Usage: GREN from to' - Insufficient number of parameters
supplied. Supply both the source and destination parameters.
'No access permitted for xxxxxxxx.xxx' - The object was marked
read-only, it was locked by another user, an error occurred
during the rename or the disk was not present.
'xxxxxxxx.xxx does not exist.' - The specified object could not
be found.
'Cannot rename to a different device.' - An attempt was made to
move a file to a different logical disk.
OPERATION - SEARCH.EXE
SEARCH.EXE is the equivalent of the VMS SEARCH command found on
the VAX. However, there are some differences. Unlike the VMS
command, SEARCH will not work predictably on binary files, nor on
files with lines longer than 255 characters. Also, you must have
ANSI.SYS loaded as a device from the CONFIG.DAT file at boot
time. Many of the VAX qualifiers are not supported in this
version, but sufficient interest in these features could prompt
their integration.
When invoking SEARCH, you must supply the name of the file for
SEARCH to operate on and the string to search for, in that order.
If they are not supplied, or are specified incorrectly, SEARCH
will prompt you for them. Wild cards as used in DOS are
supported. If you specify a wild card file name, all files
matching that wild card spec. in the current default directory
are searched. If a file does not contain the string you are
searching for, its name is not displayed.
GENCHECK - Page 13
Search strings may be supplied with or without double quotes. If
you specify a search string which contains blanks or special
characters, you MUST enclose it in double quotes. If you wish to
specify a search string which contains a quote, either single or
double, do not supply it on the command line. Search strings
entered at the prompt are read literally, without the need of
enclosing quotes, and single and double quotes may be specified
there.
Other command line parameters you may wish to supply, but for
which you will not be prompted, include the following:
OUTPUT= - To direct the output of the search function to a file
or device, precede its name with the characters OUTPUT= in upper,
mixed or lower case. Do not include any blanks. SEARCH will
write it's output to this file and not the screen. If the file
already exists, it is over-written without any warning. SEARCH
highlights each occurrence of your search string when the output
is going to the screen by using ANSI.SYS escape code sequences.
Since these sequences would garble the output if it were going to
a file and lock up (!) most printers, this is not done if the
output is redirected.
WORD - or any abbreviation thereof, in upper, mixed or lower
case. If selected, SEARCH will only display those occurrences of
the search string which are not immediately preceded or followed
by other letters, i.e. those strings which are entire words.
NOEXACT - or any abbreviation thereof, in upper, mixed or lower
case. If chosen, SEARCH will ignore the case of all letters in
matching the search string.
BEFORE - the number of lines that SEARCH is to display that
precede the located search string. If this number of lines is
not available when SEARCH encounters the string, it will display
what it has.
AFTER - the number of lines that SEARCH is to display that follow
the located search string. If this number of lines is not
available when SEARCH encounters the string, it will display what
it has.
SEARCH will apply the first integer you supply in the command
line to the BEFORE parameter and the second (and all subsequent
ones) to the AFTER qualifier. If you wish to have extra lines
displayed after the occurrence but not before, you must still
specify a value of zero(0) for BEFORE.
Input file name must appear first, but other parameters may be
intermixed.
An example:
GENCHECK - Page 14
C> search *.c printf 3 output=lpt1 3 word
This command entry would cause SEARCH to find and print all
occurrences of the string 'printf' (but not 'sprintf' and
'fprintf' because WORD was specified) in all the files which
match the wild card name '*.c' in the current directory on the
printer attached to the first parallel port of the machine. Each
occurrence would be preceded and followed by the 3 surrounding
lines in the file.
Another example:
C> search *.h " _MAX_LINE " 0 4 output=match.max
This command entry would cause SEARCH to find and print all
occurrences of the string ' _MAX_LINE ' (note the leading and
trailing blanks; ' _MAX_LINE_NUM' and 'OUT_MAX_LINE ' would NOT
be found) to the output file MATCH.MAX. Each occurrence would be
listed with the four lines which follow it in the file.
Only files written with CR or CR-LF record separators will work
correctly with SEARCH. EDLIN, QuickC, EDT+ and PC-EDT all
produce files of this type. Files downloaded to the PC with
KERMIT or XMODEM are usually written in this manner. Files
created with MultiMate, DisplayWrite and ManuScript must be
exported to ASCII before SEARCH can be used effectively on them.
Maximum number of...
files per search - unlimited
lines per file - 32767
chars per line - 255
lines before occurrence - 255 (approx.)
lines after occurrence - unlimited
A LOOK AHEAD
This version of the CSS Desktop Utilities would not have been
possible without the assistance of many registered users who
contributed their ideas for new this new product. In order for
us to serve you better, please contact us with your ideas about
new features for our programs. New feature suggestions are
always welcome; registered users may forward them to:
Common Sense Software
P.O. Box 50941
Indianapolis, Indiana 46250
Most importantly, we wish to thank our registered users for
continuing to support the Shareware concept by registering their
software and encouraging others to evaluate and register. As
registrations are our only means of support for these programs,
we are indebted to you for your honesty.
GENCHECK - Page 15
REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0
Last Name _____________________________ First Name _____________
Address ________________________________________________________
City _______________________ State __________ Zip ______________
Phone (______) ______ - ________
Where did you hear about these programs? ________________________
_________________________________________________________________
Hardware Configuration:
____ PC or clone ____ AT or clone ____ 386/486 ____ PS/2
____ Monochrome ____ CGA color ____ EGA ____ VGA
____ Floppy ____ Hard Disk (if checked, size: ____ MB)
____ Mouse ____ Modem Printer type ___________________
Floppy Disk Type: ____ 5.25" ____ 3.5"
VISA/MasterCard# __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __
Expiration Date: ___ / ___ Authorized Signature: _______________
Mail this form with your check for $10 (payable to Common Sense
Software) in U.S. DOLLARS ONLY, or VISA / MasterCard number to:
CSS Desktop Utilities Registration
Common Sense Software
P.O. Box 50941
Indianapolis, Indiana 46250
THANK YOU!!